/**
 * @file    utils.h
 * @author  wuhui1536@gmail.com
 * @date    2025-02-19
 * @brief   工具类 - 实现文件
 *
 * @details
 * 本文件包含多个工具函数的实现，用于支持项目中各种常见的操作。
 * 这些工具函数包括字符串处理、文件操作、数据转换等常用功能，旨在提高代码复用性和可维护性。
 * 每个函数都有独立的功能，能在不同的模块中被调用，简化开发工作。
 * 
 * 文件中的函数应避免与其他模块的功能发生冲突，并保持良好的代码规范。
 * 
 * @note
 * 1. 本文件中所有函数已尽量做到通用性，未来如有需要扩展的功能，请在此文件中新增函数。
 * 2. 请确保对所有新加入的函数进行充分的单元测试。
 * 
 */

#ifndef UTILS_H
#define UTILS_H

#include <iostream>
#include <fstream>
#include <sstream>
#include <string>
#include <cctype>

using namespace std;

// 工具类，提供通用的静态函数
class Tool {
public:
    /**
     * @brief 读取 JSON 文件内容
     * @param filename 要读取的 JSON 文件路径
     * @return 返回 JSON 文件的内容字符串
     */
    static string readJsonFile(const string &filename);

    /**
     * @brief 将字符串转换为小写
     * @param input 需要转换的字符串
     * @return 转换后的小写字符串
     */
    static string toLowerCase(const string &input);
};

#endif // UTILS_H